home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat3 / Tcl / info.z / info
Encoding:
Text File  |  2002-10-03  |  9.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiinnnnffffoooo((((3333TTTTccccllll))))                                                          iiiinnnnffffoooo((((3333TTTTccccllll))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      info - Return information about the state of the Tcl interpreter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnnffffoooo _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      This command provides information about various internals of the Tcl
  17.      interpreter.  The legal _o_p_t_i_o_n's (which may be abbreviated) are:
  18.  
  19.      iiiinnnnffffoooo aaaarrrrggggssss _p_r_o_c_n_a_m_e
  20.           Returns a list containing the names of the arguments to procedure
  21.           _p_r_o_c_n_a_m_e, in order.  _P_r_o_c_n_a_m_e must be the name of a Tcl command
  22.           procedure.
  23.  
  24.      iiiinnnnffffoooo bbbbooooddddyyyy _p_r_o_c_n_a_m_e
  25.           Returns the body of procedure _p_r_o_c_n_a_m_e.  _P_r_o_c_n_a_m_e must be the name
  26.           of a Tcl command procedure.
  27.  
  28.      iiiinnnnffffoooo ccccmmmmddddccccoooouuuunnnntttt
  29.           Returns a count of the total number of commands that have been
  30.           invoked in this interpreter.
  31.  
  32.      iiiinnnnffffoooo ccccoooommmmmmmmaaaannnnddddssss ?_p_a_t_t_e_r_n?
  33.           If _p_a_t_t_e_r_n isn't specified, returns a list of names of all the Tcl
  34.           commands, including both the built-in commands written in C and the
  35.           command procedures defined using the pppprrrroooocccc command.  If _p_a_t_t_e_r_n is
  36.           specified, only those names matching _p_a_t_t_e_r_n are returned.  Matching
  37.           is determined using the same rules as for ssssttttrrrriiiinnnngggg mmmmaaaattttcccchhhh.
  38.  
  39.      iiiinnnnffffoooo ccccoooommmmpppplllleeeetttteeee _c_o_m_m_a_n_d
  40.           Returns 1 if _c_o_m_m_a_n_d is a complete Tcl command in the sense of
  41.           having no unclosed quotes, braces, brackets or array element names,
  42.           If the command doesn't appear to be complete then 0 is returned.
  43.           This command is typically used in line-oriented input environments
  44.           to allow users to type in commands that span multiple lines;  if the
  45.           command isn't complete, the script can delay evaluating it until
  46.           additional lines have been typed to complete the command.
  47.  
  48.      iiiinnnnffffoooo ddddeeeeffffaaaauuuulllltttt _p_r_o_c_n_a_m_e _a_r_g _v_a_r_n_a_m_e
  49.           _P_r_o_c_n_a_m_e must be the name of a Tcl command procedure and _a_r_g must be
  50.           the name of an argument to that procedure.  If _a_r_g doesn't have a
  51.           default value then the command returns 0000.  Otherwise it returns 1111
  52.           and places the default value of _a_r_g into variable _v_a_r_n_a_m_e.
  53.  
  54.      iiiinnnnffffoooo eeeexxxxiiiissssttttssss _v_a_r_N_a_m_e
  55.           Returns 1111 if the variable named _v_a_r_N_a_m_e exists in the current
  56.           context (either as a global or local variable), returns 0000 otherwise.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiinnnnffffoooo((((3333TTTTccccllll))))                                                          iiiinnnnffffoooo((((3333TTTTccccllll))))
  71.  
  72.  
  73.  
  74.      iiiinnnnffffoooo gggglllloooobbbbaaaallllssss ?_p_a_t_t_e_r_n?
  75.           If _p_a_t_t_e_r_n isn't specified, returns a list of all the names of
  76.           currently-defined global variables.  If _p_a_t_t_e_r_n is specified, only
  77.           those names matching _p_a_t_t_e_r_n are returned.  Matching is determined
  78.           using the same rules as for ssssttttrrrriiiinnnngggg mmmmaaaattttcccchhhh.
  79.  
  80.      iiiinnnnffffoooo lllleeeevvvveeeellll ?_n_u_m_b_e_r?
  81.           If _n_u_m_b_e_r is not specified, this command returns a number giving the
  82.           stack level of the invoking procedure, or 0 if the command is
  83.           invoked at top-level.  If _n_u_m_b_e_r is specified, then the result is a
  84.           list consisting of the name and arguments for the procedure call at
  85.           level _n_u_m_b_e_r on the stack.  If _n_u_m_b_e_r is positive then it selects a
  86.           particular stack level (1 refers to the top-most active procedure, 2
  87.           to the procedure it called, and so on); otherwise it gives a level
  88.           relative to the current level (0 refers to the current procedure, -1
  89.           to its caller, and so on).  See the uuuupppplllleeeevvvveeeellll command for more
  90.           information on what stack levels mean.
  91.  
  92.      iiiinnnnffffoooo lllliiiibbbbrrrraaaarrrryyyy
  93.           Returns the name of the library directory in which standard Tcl
  94.           scripts are stored.  This is actually the value of the ttttccccllll____lllliiiibbbbrrrraaaarrrryyyy  |
  95.           variable and may be changed by setting ttttccccllll____lllliiiibbbbrrrraaaarrrryyyy.  See the ttttccccllllvvvvaaaarrrrssss|
  96.           manual entry for more information.
  97.  
  98.      iiiinnnnffffoooo llllooooccccaaaallllssss ?_p_a_t_t_e_r_n?
  99.           If _p_a_t_t_e_r_n isn't specified, returns a list of all the names of
  100.           currently-defined local variables, including arguments to the
  101.           current procedure, if any.  Variables defined with the gggglllloooobbbbaaaallll and
  102.           uuuuppppvvvvaaaarrrr commands will not be returned.  If _p_a_t_t_e_r_n is specified, only
  103.           those names matching _p_a_t_t_e_r_n are returned.  Matching is determined
  104.           using the same rules as for ssssttttrrrriiiinnnngggg mmmmaaaattttcccchhhh.
  105.  
  106.      iiiinnnnffffoooo ppppaaaattttcccchhhhlllleeeevvvveeeellll
  107.           Returns the value of the global variable ttttccccllll____ppppaaaattttcccchhhhLLLLeeeevvvveeeellll; see the    |
  108.           ttttccccllllvvvvaaaarrrrssss manual entry for more information.
  109.  
  110.      iiiinnnnffffoooo pppprrrrooooccccssss ?_p_a_t_t_e_r_n?
  111.           If _p_a_t_t_e_r_n isn't specified, returns a list of all the names of Tcl
  112.           command procedures.  If _p_a_t_t_e_r_n is specified, only those names
  113.           matching _p_a_t_t_e_r_n are returned.  Matching is determined using the
  114.           same rules as for ssssttttrrrriiiinnnngggg mmmmaaaattttcccchhhh.
  115.  
  116.      iiiinnnnffffoooo ssssccccrrrriiiipppptttt
  117.           If a Tcl script file is currently being evaluated (i.e. there is a
  118.           call to TTTTccccllll____EEEEvvvvaaaallllFFFFiiiilllleeee active or there is an active invocation of the
  119.           ssssoooouuuurrrrcccceeee command), then this command returns the name of the innermost
  120.           file being processed.  Otherwise the command returns an empty
  121.           string.
  122.  
  123.      iiiinnnnffffoooo ttttccccllllvvvveeeerrrrssssiiiioooonnnn
  124.           Returns the value of the global variable ttttccccllll____vvvveeeerrrrssssiiiioooonnnn; see the       |
  125.           ttttccccllllvvvvaaaarrrrssss manual entry for more information.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiinnnnffffoooo((((3333TTTTccccllll))))                                                          iiiinnnnffffoooo((((3333TTTTccccllll))))
  137.  
  138.  
  139.  
  140.      iiiinnnnffffoooo vvvvaaaarrrrssss ?_p_a_t_t_e_r_n?
  141.           If _p_a_t_t_e_r_n isn't specified, returns a list of all the names of
  142.           currently-visible variables, including both locals and currently-
  143.           visible globals.  If _p_a_t_t_e_r_n is specified, only those names matching
  144.           _p_a_t_t_e_r_n are returned.  Matching is determined using the same rules
  145.           as for ssssttttrrrriiiinnnngggg mmmmaaaattttcccchhhh.
  146.  
  147.  
  148. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  149.      command, information, interpreter, level, procedure, variable
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.